home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-05 / pcelm30.zip / PCELM.MAN < prev    next >
Text File  |  1991-11-05  |  39KB  |  927 lines

  1. PCElm 3.0 - Installation and User Manual
  2.  
  3.  
  4. 0) Files
  5. 1) About PCElm and where and how to get it
  6. 2) History and Version Numbers
  7. 3) Installation
  8.     3.1 Configuration File
  9.     3.2 Environment Variables
  10.     3.3 Other Files
  11.     3.4 Starting PCElm
  12. 4) Using PCElm
  13. 5) Troubleshooting
  14. 6) Notes for interfacing with UUCP
  15. 7) Languages
  16. 8) Credits
  17. 9) The Future
  18.  
  19.  
  20. 0) Files
  21.     This package contains the following files:
  22.  
  23.     Name            Description
  24.     ----------------------------------------------------------------
  25.     ALIAS           Example alias file
  26.     MARVIN   SIG    Example signature file
  27.     PCELM    RC     PCElm configuration file
  28.     PCELM    DEU    PCElm message file, german language
  29.     PCELM    ENG    PCElm message file, english language
  30.     PCELM    MAN    PCElm installation and user manual
  31.     PCELM    EXE    PCElm executable
  32.  
  33.  
  34. 1) About PCElm and where and how to get it
  35.     PCElm is a mail user agent (UA) with a user interface closely
  36.     modeled after the USENET ELM. To avoid confusion, we would like to
  37.     mention that PCElm and USENET ELM are *not* related.
  38.  
  39.     PCElm is intended to be used as a drop-in replacement for BM when
  40.     using the KA9Q NOS package or as a replacement for mail.exe when
  41.     using UUPC. It can also be used for other mailsystems, as all relevant
  42.     things for compatibility with MTA's (Message Transfer Agents) are
  43.     configurable.
  44.  
  45.     Hilights:
  46.     PCElm has a nice user interface, with easy to learn and easy to use
  47.     commands. UN*X users will already be familiar with the more important
  48.     commands. It can be made to work with just about every mail system
  49.     there is for PC's, as PCElm makes no assumptions at all about the
  50.     underlying network software. Finally, PCElm is multilingual; you can
  51.     make all messages appear in your favorite language. Message files
  52.     for English and German currently exist.
  53.  
  54.     PCElm in hamradio mode creates text- and workfiles directly usable
  55.     by NET or NOS for distribution with SMTP. In UUCP mode, PCElm
  56.     execs a uucp mailer (usually rmail.exe) to feed mail to your
  57.     uucp program. Since there are many uucp programs for PCs out there,
  58.     it is up to you to find the right way to exec the mailer (See the
  59.     discussion on the uucpcall parameter below). As our knowledge
  60.     of UUPC, WAFFLE etc. is limited, we can't help there.
  61.  
  62.     PCElm is Copyright (C) 1988,89,90,91 by Wolfgang Siebeck and
  63.     Martin Freiss.
  64.  
  65.     The executable pcelm.exe may be freely copied and distributed, provided
  66.     that all files in this package are distributed with it and provided that
  67.     the copyright notices are retained. No money may be charged for copying
  68.     PCElm. A license is given to use PCElm for an unlimited time in
  69.     non-commercial environments.
  70.  
  71.     No warranty, expressed or implied, is given that PCElm does what you
  72.     think it does. The usual disclaimers apply: It works for us.
  73.  
  74.     Should you want or need support in setting up PCElm beyond the scope
  75.     of this manual, want us to include special features in PCElm, want
  76.     to include PCElm with your product or otherwise use PCElm in a
  77.     commercial environment (i.e. make money out of people using PCElm),
  78.     contact us.
  79.  
  80.     If you need support from us, we would request that you register PCElm
  81.     with us for a fee of 10$ or the equivalent amount in your favorite
  82.     currency (20 DM or 6 british pounds at current rates). No checks or MO's
  83.     please; exchange fees for foreign currency checks are more than 10$
  84.     over here. A (rather nice) printed manual is available from Wolfgang
  85.     Siebeck for registered users for an additional fee of $7.
  86.  
  87.     If you don't need support, we wouldn't complain about a donation
  88.     either :-)
  89.  
  90.     If you would like the source code (C, with Turbo C 2.0((C) Borland) or
  91.     later versions, Borland C++ recommended), the fee is 30$.
  92.       The rationale behind this is that support costs us both time and money
  93.     (as you might know, Germany has the highest postal and telephone charges
  94.     in the world). 2 Emails of 5 KB length to overseas already eat up the
  95.     10$.
  96.  
  97.     We can be reached at
  98.  
  99.     Wolfgang Siebeck        -or-    Martin Freiss
  100.     Rosstr. 38-40                   Muehlenfloessstr. 60
  101.     D-W 5100 Aachen                 D-W 4792 Bad Lippspringe
  102.     Germany                         Germany
  103.  
  104.     Email:
  105.     siebeck@infoac.rmi.de           freiss.pad@sni.de
  106.  
  107.     Email is preferred.
  108.  
  109.     Bug reports are welcome if they are complete, i.e. please specify
  110.     all configuration parameters, your hardware, version of NOS or uucp
  111.     software, and send an excerpt of the mailbox you are having trouble
  112.     with if necessary. We can't fix bugs we can't reproduce.
  113.     Suggestions for enhancements to PCElm are of course also welcome.
  114.  
  115. 2) History and Version Numbers
  116.  
  117.     PCElm was originally based on BM, Bdales Mailer, by Barksdale Garbee II,
  118.     N3EUA, version 3.0, reworked by Gerard van der Grinten, PA0GRI,
  119.     Phil Karn, KA9Q, and Dave Trulli, NN2Z. BM at that time was a UNIX mail
  120.     lookalike with a restricted set of commands.
  121.  
  122.     Someday in early 1988, Martin added a reply-include-old-message command
  123.     to BM, and later that year, with the advent of Turbo C 1.5, Wolfgang
  124.     Siebeck devised the user interface modeled after Dave Taylor's ELM.
  125.     Creeping featurism then set in, and more and more capabilities were
  126.     added, until all resemblances to BM ceased to exist. This mailer
  127.     was then renamed to PCElm.
  128.  
  129.     The version number went to 1.9 in middle 1989 and stopped there.
  130.     We had no real use for PCElm any more then, as we both had bigger
  131.     computers than PCs to play around with at that time :-).
  132.     PCElm at this time had never been officially distributed, we just gave
  133.     some copies to friends in Germany and the Netherlands.
  134.  
  135.     Imagine our surprise, when, in 1990, mail began to trickle in from
  136.     PCElm users in Britain and the US and it developed that there was a
  137.     large user community.
  138.     In late 1990 Kelvin Hill, G1EMM, took over development of PCElm, as
  139.     we did not have time to develop PCElm further.
  140.  
  141.     Sadly, Kelvin dropped development in early 1991 due to work
  142.     pressure. At that time, he had developed versions 2.0 to 2.2 and
  143.     distributed them. Unluckily enough, we don't know what's in these
  144.     versions. Rumour has it that Kelvin intended to incorporate a news
  145.     reader for use with KA9Q NOS's NNTP capabilities, but to our
  146.     knowledge this did not happen.
  147.  
  148.     PCElm 3.0 was then written in August 1991, again by Wolfgang Siebeck
  149.     and Martin Freiss. PCElm 3.0 is the 'official' son of PCElm 1.9a.
  150.     We hope that this will end the version number confusion regarding
  151.     PCElm.
  152.  
  153. 3) Installation
  154.  
  155.     First, set the environment variable HOME to point to the directory
  156.     where PCElm's configuration file and alias file reside.
  157.     This environment variable is mandatory! PCElm will not start up
  158.     without it (see also 3.2, environment variables).
  159.     Example:
  160.     set HOME=d:\usr\marvin
  161.  
  162.     'CD' to your home directory, if you are not already there.
  163.     Then, select the language you want to use by copying or renaming the
  164.     appropriate message file to 'pcelm.msg'. The message files 'pcelm.eng'
  165.     (English) and 'pcelm.deu' (German) are included in this distribution.
  166.     Example:
  167.     cd \usr\marvin
  168.     copy pcelm.eng pcelm.msg
  169.  
  170.     For this manual, we assume that you are using the English language.
  171.     If you want to use another language, read chapter 7 first, which
  172.     discusses setups for foreign languages in more detail.
  173.  
  174.     3.1 Configuration File
  175.     ----------------------
  176.     PCElm needs to know a lot of things about your MTA and your computer
  177.     to function properly.
  178.  
  179.     You need to configure PCElm's configuration file, pcelm.rc, before
  180.     starting PCElm for the first time. DO NOT USE THE EXAMPLE pcelm.rc
  181.     DISTRIBUTED IN THIS PACKAGE AS-IS. Edit it first with an ASCII-Editor
  182.     of your choice.
  183.  
  184.     pcelm.rc is a pure ASCII-file. Lines that start with a hash '#' or
  185.     empty lines are regarded as comments.
  186.  
  187.     Other lines are of the form <keyword><blank><information>. The
  188.     keywords that PCElm knows about are explained in detail below.
  189.     Note that ASCII space is used as a delimiter; if you need to include
  190.     a space in the information field, you can put double quotes '"'
  191.     around it. If (for whatever reason) you need to insert control
  192.     characters into a line, write them as escaped decimals (i.e.
  193.     \001 would be Ctrl-A). Some more escapes PCElm knows about are
  194.     \n, newline, \r, carriage return, \\ backslash, and \t, tab.
  195.     Note that PCElm likes slashes in pathnames, not backslashes, i.e.
  196.     you must write a path like "c:\spool\mail" as "c:/spool/mail".
  197.     Example:
  198.     SOH-UUCP "From "
  199.     Keywords are case insensitive.
  200.     Keyword is one of:
  201.  
  202.     HOST
  203.     ----
  204.     This is the hostname to be used for the hamradio mode. It usually
  205.     is your callsign followed by .ampr.org, as in "dg5kx.ampr.org"
  206.     Example:
  207.     host dg5kx.ampr.org
  208.  
  209.     UUCPHOST
  210.     --------
  211.     This is the hostname to be used for uucp mode. Note: traditional
  212.     uucp hostnames need to be unique, so know what you are doing here.
  213.     This is usually either your hostname followed by .uucp as in
  214.     "dg5kx.uucp" or a fully qualified domain name (FQDN) as in
  215.     "dg5kx.rmi.de".
  216.     Example:
  217.     uucphost dg5kx.uucp
  218.  
  219.     USER
  220.     ----
  221.     This is the name of your mailbox. It usually is your username (login)
  222.     at this system. (Note that this puts an 8 character length restriction
  223.     on your username, as MessDOS can't handle more characters).
  224.     If this entry is commented out, the value of the environment variable
  225.     'mailbox' is used.
  226.     Example:
  227.     user marvin
  228.  
  229.     FULLNAME
  230.     --------
  231.     Your real life name belongs here. This is so that other people can see
  232.     who you really are, even if your username is 'gandalf' or 'blackadder'.
  233.     (No disrespect meant if you are really called Gandalf).
  234.     If this entry is commented out, the value of the environment variable
  235.     'name' is used.
  236.     Example:
  237.     fullname "Martin W Freiss"
  238.  
  239.     REPLY
  240.     -----
  241.     Use this if you want replies to your messages to go to another machine
  242.     or if you are on a network where headers are mangled so badly people
  243.     can't reply to you otherwise. If you aren't sure, set it to your
  244.     own email address.
  245.     Example:
  246.     reply freiss.pad@sni.de
  247.  
  248.     ZONE
  249.     ----
  250.     The timezone you are living in. Should be 3 characters, not more, not less.
  251.     There is an ISO standard for time zone names if memory serves me correctly,
  252.     but the ISO number escapes me.
  253.     Example:
  254.     zone MET
  255.  
  256.     MAXLET
  257.     ------
  258.     The maximum number of messages that may be in a mailbox at once.
  259.     Decrease this number if you are short on memory. PCElm startup will slow
  260.     down considerably if have a huge mailbox; on the other hand I doubt
  261.     anybody can find his way around 300 messages in a single mailbox.
  262.     Example:
  263.     maxlet 300
  264.  
  265.     EDIT
  266.     ----
  267.     The filename of your favorite editor goes here, This should be a small
  268.     editor capable of producing true ASCII files (if possible with no
  269.     Control-Z at the end, though PCElm tries to zap Ctrl-Z's if it sees them).
  270.     What I'm trying to convey here is that Word for Windows ((C) Microsoft)
  271.     is not the sort of thing you want to put here.
  272.     If this entry is commented out, the value of the environment variable
  273.     'editor' is used.
  274.     If you don't have an editor handy (edlin doesn't count :-)), try
  275.     builtin+
  276.     as editor. This is a small full screen editor that is hardcoded into
  277.     PCElm. Nothing fancy, and it still has some raw edges, but it works.
  278.     See end of chapter 4 for a brief discussion of the commands the
  279.     editor understands.
  280.     Example:
  281.     edit dte
  282.  
  283.     SMTP
  284.     ----
  285.     This is where you put the directory where your mailboxes reside. All
  286.     mailboxes, i.e. both the hamradio and uucp mailboxes should be in one
  287.     directory.
  288.     If this entry is commented out, the value of the environment variable
  289.     'maildir' is used.
  290.     (Don't worry about the curious name SMTP. It's called that way for
  291.     historical reasons and compatibility with BM).
  292.     Example:
  293.     smtp c:/spool/mail
  294.  
  295.     QUEUEDIR
  296.     --------
  297.     This is where you put the directory where outgoing mail gets queued up.
  298.     Typically, this is called /spool/mqueue or something like that. This is
  299.     for hamradio mode only; in UUCP mode, the exterior mailer determines
  300.     where it queues mail.
  301.     Example:
  302.     queuedir c:/spool/mqueue
  303.  
  304.     VIDEO
  305.     -----
  306.     Put a 1 here if you want direct writes into video ram, which is fast
  307.     but tends to confuse CGAs and not-so-very-compatible PCs. A 0 will
  308.     do all video updates through the BIOS, which is painfully slow.
  309.     Example:
  310.     video 1
  311.  
  312.     SOH-UUCP
  313.     --------
  314.     This is a sequence of words that tell PCElm that a new message begins.
  315.     Uh.. message delimiter is the word I was looking for. Usually "From ",
  316.     but may be anything at all if you are using weird mailers.
  317.     If you have MMDF-style mailboxes (like in UUPC/extended), use the special
  318.     keyword mmdf; otherwise, "From " (note the blank) or "Received "
  319.     usually work.
  320.     Example:
  321.     SOH-UUCP "From "
  322.     ( or, if you are using UUPC/extended,
  323.     SOH-UUCP mmdf                )
  324.  
  325.     SOH-HAM
  326.     -------
  327.     See above, but for ham radio.
  328.     Example:
  329.     SOH-ham "From "
  330.  
  331.     HAM-EXT
  332.     -------
  333.     Extension for amateur radio
  334.     The file extension your mailbox file has goes here. A mailbox is
  335.     constructed from your username with the extension defined here appended to
  336.     it. Note that even if your mailbox has no extension, you still need
  337.     to define the dot "." as extension ! The dot is mandatory.
  338.     Example:
  339.     ham-ext ".txt"
  340.  
  341.     UUCP-EXT
  342.     --------
  343.     Extension for UUCP
  344.     See above, but for uucp.
  345.     UUPC usually has no extension, so we just define the dot as extension.
  346.     Example:
  347.     uucp-ext "."
  348.  
  349.     START
  350.     -----
  351.     Startmode for PCElm. If Startmode is "uucp", PCElm will start in
  352.     uucp mode; anything else will cause PCElm to start in hamradio mode.
  353.     Example:
  354.     START hamradio
  355.  
  356.     COLORS
  357.     ------
  358.     Define various colours for display:
  359.     The numbers below are hexadecimal numbers defining a foreground and
  360.     background colour for various scenarios. The routine determining the
  361.     colours is quite simpleminded, so please don't use spaces here.
  362.  
  363.     If you are confused as to what to enter here, either leave it alone
  364.     or consult an IBM PC programming manual as to how these numbers are
  365.     arrived at.
  366.  
  367.     The color codes are as follows:
  368.  
  369.       Background    |    Foreground
  370.     ---------------------------------
  371.     0   0   0   1   |   1   1   1   1 ---> 0x1f ---> Bright white on blue
  372.     ---------------------------------
  373.     B   R   G   B   |   I   R   G   B
  374.     L   E   R   L   |   N   E   R   L
  375.     I   D   E   U   |   T   D   E   U
  376.     N       E   E   |   E       E   E
  377.     K       N       |   N       N
  378.  
  379.     This will definitely get more comfortable to configure in a later version
  380.     of PCElm.
  381.  
  382.     Values are: normal screen, bold, more prompt, default at exit,
  383.     selection bar.
  384.  
  385.     Example:
  386.     COLORS 1f,4f,2f,07,6f
  387.  
  388.     UUCPCALL
  389.     --------
  390.     Format of uupc command
  391.     Supported macros are:
  392.     $   filename containing message header and body
  393.     %   name of recipient
  394.     &   subject of message (you shouldn't need this)
  395.  
  396.     PCElm constructs the workfiles and messagefiles that KA9Q NET and NOS
  397.     needs by itself, but execs an exterior mailer in uucp mode so that
  398.     headers peculiar to your particular implementation of uucp (or whatever)
  399.     can be written. The exterior mailer is usually called rmail.exe or
  400.     mail.exe. The macros $, & and % are expanded _once_, they may not occur
  401.     multiple times in this line.
  402.     For my version of UUPC (quite old), the following line works.
  403.     Example:
  404.     uucpcall "rmail % < $"
  405.  
  406.     or, try
  407.  
  408.     uucpcall "rmail -f $ %"
  409.  
  410.     for UUPC/extended newer versions. This works with UUPC/extended 1.11k
  411.     and foregoes the need for a temporary file (should be a little bit
  412.     faster).
  413.  
  414.     SEQUENCE
  415.     --------
  416.     Name of sequence file.
  417.     This is the file where the numbers for message id's are stored.
  418.     It is located in the mail spool directory.
  419.     Example:
  420.     sequence sequence.seq
  421.  
  422.     PRINT
  423.     -----
  424.     Name of print device.
  425.     Put the device name of your line printer here, e.g. LPT1, LPT2 or
  426.     LPT3. If you want to connect a serial printer, use 'mode' (the DOS
  427.     command) to tie a serial port to a LPT device.
  428.     Example:
  429.     print lpt1
  430.  
  431.     WEEDOUT
  432.     -------
  433.     Headerlines to hide.
  434.     A weedout list is a list of headerlines that you don't want to see
  435.     when mail is displayed. It is annoying to get mail with 2 lines of text
  436.     and 60 lines of header; using weedout you can shrink the displayed
  437.     headers to just a few lines or nothing at all.
  438.     Put the beginning of the headerline(s) after the weedout directive,
  439.     and remember you need to quote the weedout list if there are spaces
  440.     in it!
  441.     Example:
  442.     weedout "Reply-To: Message-Id: From: To: Subject: Received: From\32"
  443.  
  444.     With this example, you just get to see the Date: line, Status: line
  445.     and X- headerlines if present.
  446.  
  447.  
  448.     3.2 Environment Variables
  449.     -------------------------
  450.     The environment variable HOME is mandatory. It must be set to the
  451.     directory where the configuration file pcelm.rc resides. The alias
  452.     file for mail aliases is also expected in the HOME directory.
  453.     At the DOS prompt, type "set home=<your_home_directory>" or include
  454.     that line in your autoexec.bat.
  455.     Example:
  456.     set home=d:\usr\marvin
  457.  
  458.     As you may have noticed in 3.1, PCElm can also take some configuration
  459.     parameters from environment variables. This is for backwards compatibility
  460.     with older versions of PCElm. If a configuration parameter is specified
  461.     both in an environment variable and in pcelm.rc, pcelm.rc wins.
  462.  
  463.     3.3 Other Files
  464.     ---------------
  465.     PCElm currently knows about three other files:
  466.  
  467.     ALIAS
  468.     -----
  469.     You can define aliases for often-used mail addresses, so that you need
  470.     not type the complete email address all the time. This is especially
  471.     convenient for mailings to a group of recipients.
  472.  
  473.     The alias file is called 'alias' and resides in your HOME directory.
  474.  
  475.     Lines in the alias file beginning with a hash '#' are taken to be comments.
  476.     All other lines have the format
  477.     <alias> <1st recipient> <2nd recipient> ...
  478.  
  479.     Example:
  480.     # This is my alias file
  481.     hikaru dg2kk@dg2kk.ampr.org
  482.     marvin marvin@dg5kx.ampr.org
  483.     martin freiss.pad@sni.de
  484.     andrew andrew@omega.uucp
  485.     #
  486.     broadcast dg2kk@dg2kk.ampr.org siebeck@infoac.rmi.de rmohr@infoac.rmi.de
  487.  
  488.     Note that aliases may not extend over more than one line. Maximum line
  489.     length is 127 characters. Aliases are not resolved recursively, i.e.
  490.     the recipient may not be yet another alias.
  491.  
  492.     SIGNATURE
  493.     ---------
  494.     A signature is automatically appended to your mails, if a signature
  495.     file is present. The signature file must be in your HOME directory
  496.     and has the name <username>.sig; i.e. if your username (see USER
  497.     in pcelm.rc) is marvin, the signature file is called marvin.sig .
  498.         There is no length restriction on signatures; however signatures
  499.     longer than 4 lines are generally frowned upon.
  500.  
  501.     The signature, if present, should contain your name and email address.
  502.  
  503.     PCELM.MSG
  504.     ---------
  505.     This is the message file. If you are installing a language other than
  506.     English, be sure to read chapter 7.
  507.     The message file must be in the HOME directory. Note that this makes
  508.     it possible for each user to use PCElm in his native language.
  509.  
  510.  
  511.     3.4 Starting PCElm
  512.     ------------------
  513.     Now you are ready to start PCElm. Run it on a copy of your mailbox
  514.     first, so that you won't lose your mail if something goes wrong.
  515.     Just type pcelm to start, no commandline arguments are necessary.
  516.  
  517.  
  518. 4) Using PCElm
  519.  
  520.     When PCElm starts up, it displays a status line at the top. Below that,
  521.     up to 10 messages are displayed in the index, giving from left to right
  522.     the message state (Read or Unread, Tagged, Deleted), the message number,
  523.     the sender of the mail, the date the mail was sent, the length of the
  524.     mail in Bytes and the subject line of the mail.
  525.     The subject line is truncated to fit on the screen.
  526.  
  527.     In the lower half of the screen, 4 lines list some of the more often
  528.     used commands. You type commands by pressing the highlighted letter
  529.     at the Command: prompt.
  530.  
  531.     Error messages (hopefully there aren't any) are displayed on the
  532.     bottom line.
  533.  
  534.     * Note that the 'Q' and 'X' keys have exchanged their meanings
  535.     * from previouses releases.
  536.  
  537.     A short overview of the commands available:
  538.  
  539.     Up Arrow, Down Arrow, Page Up, Page Down, Home, End
  540.         These keys move the 'select'-bar one message up, down, one page
  541.         (= 10 messages) up, one page down, to the first message, to
  542.         the last message in your mailbox.
  543.  
  544.     Return
  545.         Displays the message you have currently selected. More on
  546.         display commands below.
  547.  
  548.     +   Tag. Mark a mail for saving, deleting or forwarding.
  549.  
  550.     -   Untag. Delete a previous tag.
  551.  
  552.     F1  Function Key F1 displays a help page which lists all commands
  553.         and a short explanation of what they do.
  554.  
  555.     F2  Function Key F2 toggles the video display mode
  556.         (VRAM or BIOS writes to update the screen).
  557.  
  558.     DEL Delete the selected mail or all tagged mails.
  559.  
  560.     INS Undelete the selected mail.
  561.  
  562.     a   About PCElm. A page of text giving the version and the authors'
  563.         names. Just an ego-fix for us :-)
  564.  
  565.     c   Change mailbox. This allows you to change your user id without
  566.         leaving PCElm. For example, ham radio operators often have
  567.         their first name as username and their call sign as another
  568.         username. This is probably less useful in uucp.
  569.         You will be prompted for a new fullname to match your new user
  570.         id and you are prompted for a new hostname.
  571.  
  572.     C   Colour. Toggles from the user selected colours to default colours
  573.         to default monochrome display.
  574.  
  575.     d   Delete the selected mail or all tagged mails.
  576.  
  577.     F   Freshen the mailbox. Mails marked for deletion will be deleted,
  578.         new mail that has arrived in the meantime is processed and your
  579.         mailbox is displayed anew.
  580.  
  581.     f   Forward the selected (or all tagged) mails to another user.
  582.         You will be prompted for the recipient of the forwarded mail
  583.         and for the subject line; the subject line defaults to the
  584.         original subject with (fwd) appended to it.
  585.  
  586.     l   List unsent mails. Shows what files there are in the mail queue
  587.         directory and who sent them to whom. It also gives you a chance
  588.         to kill them (last chance to zap a mail if you mistakenly sent
  589.         it). This currently works only in hamradio mode (will work in uucp
  590.         mode in the next version).
  591.  
  592.     m   Send mail. You will be prompted for the recipient of the mail
  593.         and the subject, after which you are dropped into the editor.
  594.         More on editor commands below.
  595.  
  596.     n   Next unread. Moves the select-bar to the next unread mail.
  597.  
  598.     p   Paint. Redraw the screen if it got corrupted.
  599.  
  600.     P   Print. Prints all tagged mails or the hilighted mail on a line
  601.         printer. If 'print.com' of DOS is loaded, PCElm will queue the
  602.         print job to 'print', so you can go on reading mail while your
  603.         tagged mails are printed in the background.
  604.         If 'print' is not loaded, PCElm will print the mails on the device
  605.         specified in the configuration file (parameter 'print').
  606.  
  607.     Q   Quit. Quits from PCElm, saving all changes to your mailbox.
  608.  
  609.     r   Reply to a mail. You are dropped into the editor to compose your
  610.         reply; after you are finished, mail is sent to the originator of
  611.         the mail with a subject line of "Re: <original subject>".
  612.  
  613.     R   Reply to a mail. Same as above, but the original mail is included
  614.         in your reply. This helps the recipient to understand what your
  615.         reply is all about.
  616.  
  617.     s   Save the selected mail (or all tagged mails) to a file. You will
  618.         be prompted for a filename, in which the message complete with
  619.         header will be saved.
  620.  
  621.     S   change Start Of Header (SOH). This changes the 'magic word' PCElm
  622.         looks for to determine the beginning of a mail. All sort of strange
  623.         things may happen if you set a wrong SOH; be warned that you may
  624.         destroy your mailbox if you fool around with this and then use
  625.         a command that saves your mailbox to disk. 'S' is for experimenting
  626.         and for use with mailboxes from foreign MTA's; for everyday use,
  627.         you should set the SOH from the pcelm.rc file using the SOH-HAM
  628.         and SOH-UUCP parameters.
  629.         You must do a 'c'hange mailbox for the new SOH to take effect.
  630.  
  631.     t   Transmit from file. You will be prompted for the recipient of
  632.         the mail, the subject, and the filename to transmit.
  633.         Note that usually MTAs can only send pure ASCII files, binary files
  634.         have to be encoded first.
  635.  
  636.     T   Toggle mailsystem. PCElm can handle 2 mailsystems, UUCP (Unix to
  637.         Unix CoPy) and hamradio (for use with KA9Q NOS).
  638.         When you want to switch mailsystems, hitting 'T' will prompt you
  639.         for a new username, new fullname and a new hostname, since
  640.         hostnames in the hamradio community (Example: dg5kx.ampr.org)
  641.         and UUCP community (Example: atreju.rmi.de) sometimes differ.
  642.  
  643.     u   Undelete the selected mail.
  644.  
  645.     w   Write the selected mail (or all tagged mails) to a file. You will
  646.         be prompted for a filename, in which the message will be saved
  647.         without the header.
  648.  
  649.     X   Exit. Exits from PCElm immediately, without updating your mailbox.
  650.  
  651.  
  652.     When you are prompted for new values for (for example) your fullname,
  653.     PCElm pops up a window to do this. You can then either hit return,
  654.     thus accepting the default value displayed or enter a new value.
  655.     When the new value begins with a dollar sign, it is taken to
  656.     be an environment variable (e.g. if you have an environment variable
  657.     MYNAME=beeblebrox, entering $MYNAME here causes beeblebrox to be taken
  658.     as the new value).
  659.  
  660.  
  661.     Editor Commands
  662.     ---------------
  663.     When writing mail, PCElm drops you into a very simplistic line editor
  664.     of its own. This editor is useful for writing short notes, but
  665.     for longer mails you should use another editor of your choice.
  666.     This editor must be able to take the name of a file to edit
  667.     as its one and only commandline argument (something like
  668.     "edit mail.txt" must work), and it must be able to create
  669.     pure ASCII files. If at all possible, use an editor that does
  670.     not terminate files with Control-Z.
  671.  
  672.     Commands understood by the line editor:
  673.     Commands begin with a dot '.' in the first column of a line. A dot
  674.     elsewhere in the text has no special meaning.
  675.  
  676.     .?      Help. Shows available commands.
  677.     .e      Start the editor defined in pcelm.rc.
  678.     .p      Print the message you have typed so far.
  679.     .q      Quit. Aborts the mail.
  680.     .r file Reads the file "file" into the message buffer. If "file"
  681.             contains wildcards (i.e. '*' or '?'), you will be shown
  682.             a list of files matching your command.
  683.     .m num  Inserts the mail number "num" into the message buffer.
  684.     ..      Put a dot in the first column of a line.
  685.     .       End message.
  686.  
  687.  
  688.     PCElm also sports a builtin full screen editor, which is selected
  689.     if either no editor was defined in pcelm.rc and the environment
  690.     variable EDITOR is not set or if you selected 'builtin+' as editor
  691.     in pcelm.rc.
  692.     This editor is included as 'editor of last resort'. It is definitely
  693.     not perfect yet, but we liked it so much we included it.
  694.  
  695.     Commands understood by the fullscreen editor:
  696.     Arrow keys, Pg Up, Pg Dn, Home, End
  697.             those work as you would expect and move you around in the text.
  698.     Alt-T   set tab size.
  699.     Alt-N   insert line.
  700.     Alt-W   toggle word wrapping.
  701.     Alt-Q   quit, saving text.
  702.     Alt-X   quit _without_ saving text.
  703.     Alt-D   delete line
  704.     Bsp     (backspace) delete character left from cursor.
  705.     Del     delete character under cursor.
  706.     F1      help screen
  707.  
  708.     Quirks:
  709.     Maximum linelength is 160 characters.
  710.     The bottom line on the screen is sometimes duplicated if you are scrolling;
  711.     this affects only the screen though, the text is ok.
  712.  
  713.     If you are using the builtin full screen editor and are annoyed at its
  714.     lack of functionality or bugs, tough :-). The simple fix is to use another
  715.     editor.
  716.  
  717.     Display Commands
  718.     ----------------
  719.     When reading a mail, PCElm normally displays the mail one page at a
  720.     time.
  721.  
  722.     The following keys have special meanings:
  723.  
  724.     Return  one line forward
  725.  
  726.     q       quit to menu
  727.  
  728.     /       Search. You are prompted for a string to search for. The
  729.             searching routine remembers the last item you searched for,
  730.             so you can just press Return on subsequent invocations of '/'.
  731.  
  732. 5) Troubleshooting
  733.     Some of the things that can (and will, Murphy being what he is)
  734.     go wrong and proposed solutions:
  735.  
  736.     Problem:
  737.     PCElm says 'New mail has arrived' and beeps, though there is no
  738.     new mail.
  739.  
  740.     Solution:
  741.     You probably edited your mailbox with an editor once, and now there
  742.     is a Control-Z at the end of it. This means that the mailbox file
  743.     is now one character longer than all the single mails added up, so
  744.     PCElm concludes that a new mail must have arrived in the meantime.
  745.     Using a proper editor, zap the Control-Z.
  746.  
  747.     Problem:
  748.     PCElm stubbornly says 'No Mail!', although you have verified there
  749.     _is_ mail.
  750.  
  751.     Solution:
  752.     1) The mail directory is configured wrong (check parameter SMTP in
  753.        pcelm.rc)
  754.     2) Your username is not what you think it is (check NAME in pcelm.rc)
  755.     3) The extension for your mailbox file is incorrect (check HAM-EXT
  756.         and UUCP-EXT in pcelm.rc)
  757.     4) The Start-Of-Header (SOH) is wrong, and PCElm therefore can't
  758.        parse mail headers correctly (check SOH-HAM and SOH-UUCP).
  759.  
  760.     Problem:
  761.     Mails have parts of their header missing or have parts of the header
  762.     at the _end_ of the mailbody or generally look strange.
  763.  
  764.     Solution:
  765.     The Start-Of-Header (SOH) is wrong, and PCElm therefore can't
  766.     parse mail headers correctly (check SOH-HAM and SOH-UUCP).
  767.  
  768.     Problem:
  769.     Reading mail is ok, but I can't send UUCP mail.
  770.  
  771.     Solution:
  772.     1) Check the uucpcall parameter in pcelm.rc. Verify that this commandline
  773.        works by typing it in at the DOS prompt, expanding the ! and % macros
  774.        by hand. For example, send a mail to yourself this way. If this
  775.        doesn't work, check if the uucp mailer (mail.exe or rmail.exe) is
  776.        in the path, and if the commandline is correct for your mailer
  777.        (consult your uucp documentation for this).
  778.     2) There may not be enough memory left to execute the mailer under
  779.        PCElm. Get rid of some TSR programs or decrease the MAXLET
  780.        parameter in pcelm.rc and try again.
  781.  
  782.     Problem:
  783.     When writing mail, my favorite editor does not start up when using
  784.     the .e comand.
  785.  
  786.     Solution:
  787.     The editor is either not in the path or there is not enough memory left
  788.     to start the editor. Check the path and/or get rid of some TSR programs
  789.     or decrease the MAXLET parameter in pcelm.rc and try again.
  790.  
  791.     Problem:
  792.     When writing mail, the original mail is not included when using an
  793.     exterior editor when using the 'R' command and/or everything typed
  794.     in the editor is lost.
  795.  
  796.     Solution:
  797.     PCElm needs an editor that can take a filename to edit as a commandline
  798.     argument. Check if this works by typing "<your_editor> filename" at
  799.     the DOS prompt.
  800.     Check if your editor is a pure ASCII editor. If you use a text
  801.     processing system, maybe it starts up in document mode and thus uses
  802.     a non-ASCII document representation.
  803.  
  804. 6) Notes for interfacing PCElm with UUCP programs
  805.     Since this seems to be the most difficult thing to set up, some notes
  806.     on how PCElm feeds mail to UUCP.
  807.  
  808.     PCElm is basically a User Agent. It needs another program to actually
  809.     _do_ something with the mail generated by PCElm; in uucp mode, PCElm
  810.     executes a uucp mailer to do the hard work. This mailer is usually
  811.     called 'rmail.exe'; note the 'usually', your mailer might have a
  812.     different name.
  813.  
  814.     PCElm requires that the mailer be in the path; that the mailer
  815.     accepts as argument the uucp address of the recipient and that
  816.     there is some way to get the mail into the mailer, either by
  817.     specifying the file containing the mailbody on the command line
  818.     or by feeding it to the mailer via input redirection.
  819.  
  820.     The mailer must be able to paste the header lines and the mailbody
  821.     created by PCElm to the headers it generates itself _without_
  822.     mangling them and without inserting an empty line between its own header
  823.     lines and the header supplied by PCElm.
  824.     PCElm generates the From:, To:, Subject: and Message-Id: lines itself
  825.     and feeds mail to the mailer in standard UUCP format.
  826.  
  827.     Why execute an exterior mailer at all?
  828.     The rationale behind this is that (due to the many different types
  829.     and versions of uucp software out there) it is nigh impossible to
  830.     use all the features of the MTA directly from PCElm. Only your
  831.     uucp mailer knows if you can do path aliasing and what headers are
  832.     necessary for your particular network.
  833.     On the other hand, we still want to have at least the mandatory header
  834.     lines even if the mailer is real stupid and can't generate them itself.
  835.  
  836.  
  837.     Reading mail:
  838.     It seems that new versions of UUPC use MMDF style mailboxes, i.e.
  839.     mails are separated by Control-A's. Whether or not this is a cool
  840.     thing to do is a matter of opinion. Anyway, PCElm can handle this;
  841.     use the special keyword mmdf in the SOH-UUCP parameter line
  842.     in pcelm.rc to switch PCElm into MMDF mode.
  843.     (i.e., the line in pcelm.rc should read
  844.     SOH-UUCP mmdf
  845.     ).
  846.  
  847. 7) Languages
  848.     PCElm can be configured to speak other languages than English. This
  849.     is possible because all messages displayed on the screen are contained
  850.     in a seperate message file, 'pcelm.msg'. Currently, message files
  851.     in English ('pcelm.eng') and German ('pcelm.deu') exist - if you
  852.     create your own message file in another language, be sure to send
  853.     it to us, so that we can include it (with proper credit) in the next
  854.     distribution.
  855.     The appropriate message file must be copied (or renamed) to 'pcelm.msg'
  856.     before using PCElm.
  857.  
  858.     The message file has the following format:
  859.     Empty lines and lines starting with a hash '#' are ignored.
  860.     Other lines have the form
  861.     <number>:<text>, for example
  862.     150:"This is a line"
  863.  
  864.     Never change the message number - PCElm uses this number to be able
  865.     to display the right message at the right time.
  866.     You can change the text in quotes to your liking, but be warned that
  867.     PCElm displays all and every message just as it appears in the message
  868.     file. If you do something wrong, you will end up with a fancy-looking
  869.     display. Keep a copy of the original message file for safety's sake.
  870.  
  871.     You can use escaped decimals in the message file (e.g. \\32 is ' ') as
  872.     described in chapter 3.1.
  873.  
  874.     You can also change the keys that are used as command keys in the main
  875.     menu - message 83 holds all keys (except function keys) that work.
  876.     This is a good thing if you want to keep the commands intuitive;
  877.     'c' for 'change mailbox' is good to remember in English, but (for example)
  878.     a German user would want 'W' for 'Wechsele Postfach' as a hotkey.
  879.  
  880.     If you create a message file in a new language, we would like to have
  881.     it and to include it (with proper credit given) in a future release
  882.     of PCElm.
  883.  
  884.     This manual is for the English version of PCElm. Foreign language versions
  885.     use different hotkeys for most of the commands. At the time of this
  886.     writing, this manual exists only in English, but you should be able
  887.     to figure out which keys do what from the help screen (press F1 to
  888.     see the help screen, regardless of what language you have configured).
  889.     Initial setup is the same for all versions of PCElm however.
  890.  
  891.  
  892. 8) Credits
  893.     We would like to thank Dave Taylor for programming the original ELM
  894.     and for the idea for the user interface used both in ELM and PCElm.
  895.     Thanks to Syd Weinstein, coordinator of the USENET ELM, for his
  896.     good work.
  897.     Thanks to Barksdale Garbee II, N3EUA, Gerard van der Grinten, PA0GRI,
  898.     Phil Karn, KA9Q, and Dave Trulli, NN2Z, for creating BM.
  899.  
  900.     Thanks to Andrew Hardie, ash@omega.uucp, who suffered through the
  901.     early beta versions and wins grand prize in bug-finding :-).
  902.  
  903.     We would also like to point out that PCElm is (apart from the idea
  904.     for the user interface) not in any way derived from or connected
  905.     with ELM. If you are using USENET news, the group comp.mail.elm
  906.     is NOT the place to ask questions about PCElm.
  907.  
  908. 9) The Future
  909.     Just some things that _might_ be incorporated in PCElm in a future
  910.     release and some that won't be:
  911.  
  912.     - News reading. PCElm already can be used with notes, as notes uses
  913.         a mailbox-like structure to store news articles. A news mode
  914.         for PCElm could be implemented, and it would be nice for use
  915.         with NNTP in NOS. A lot of work though. (If you are not familiar
  916.         with notes, notes is a news system that predates bnews and cnews
  917.         and is now practically extinct. News uses another (more efficient)
  918.         way of storing articles and thus has another interface to the
  919.         user agent than notes).
  920.  
  921.     - a Windows 3.0 aware PCElm. Ask Wolfgang Siebeck (siebeck@infoac.rmi.de)
  922.         for details. A beta version exists.
  923.  
  924.     - a version of PCElm for OS/2. PCElm _might_ run under OS/2 in the
  925.         DOS window; I have no way of finding out.
  926.  
  927.